home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / jobs.z / jobs
Text File  |  1998-10-30  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4. jjjjoooobbbbssss((((1111))))                                                                jjjjoooobbbbssss((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      jjjjoooobbbbssss - display status of jobs in the current session
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      jjjjoooobbbbssss [ ----llll | ----pppp][jjjjoooobbbb____iiiidddd...]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The jjjjoooobbbbssss utility displays the status of jobs that were started in the
  16.      current shell environment; see Shell Execution Environment.
  17.  
  18.      When jjjjoooobbbbssss reports the termination status of a job, the shell removes its
  19.      process ID from the list of those "known in the current shell execution
  20.      environment".
  21.  
  22. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  23.      The jjjjoooobbbbssss utility supports the XBD specification, Utility Syntax
  24.      Guidelines.
  25.  
  26.      The following options are supported:
  27.  
  28.      ----llll  (The letter ell.) Provide more information about each job listed.
  29.          This information includes the job number, current job, process group
  30.          ID, state and the command that formed the job.
  31.  
  32.      ----pppp  Display only the process IDs for the process group leaders of the
  33.          selected jobs.
  34.  
  35.      By default, the jjjjoooobbbbssss utility displays the status of all stopped jobs,
  36.      running background jobs and all jobs whose status has changed and have
  37.      not been reported by the shell.
  38.  
  39. OOOOPPPPEEEERRRRAAAANNNNDDDDSSSS
  40.      The following operand is supported:
  41.  
  42.      jjjjoooobbbb____iiiidddd   Specifies the jobs for which the status is to be displayed. If
  43.               no jjjjoooobbbb____iiiidddd is given, the status information for all jobs will be
  44.               displayed. The format of jjjjoooobbbb____iiiidddd is described in the entry for
  45.               job control job ID in the sssshhhh((((1111)))) manpage.
  46.  
  47. SSSSTTTTDDDDOOOOUUUUTTTT
  48.      If the ----pppp option is specified, the output consists of one line for each
  49.      process ID:
  50.  
  51.           "%d\n", <process ID>
  52.  
  53.      Otherwise, if the ----llll option is not specified, the output is a series of
  54.      lines of the form:
  55.  
  56.           "[%d] %c %s %s\n", <job-number>, <current>, <state>, <command>
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. jjjjoooobbbbssss((((1111))))                                                                jjjjoooobbbbssss((((1111))))
  71.  
  72.  
  73.  
  74.      where the fields are as follows:
  75.  
  76.      <current>      The character "++++" identifies the job that would be used as
  77.                     a default for the ffffgggg or bbbbgggg utilities; this job can also be
  78.                     specified using the job_id %%%%++++ or %%%%%%%%. The character "----"
  79.                     identifies the job that would become the default if the
  80.                     current default job were to exit; this job can also be
  81.                     specified using the job_id %%%%----. For other jobs, this field
  82.                     is a space character. At most one job can be identified
  83.                     with "++++" and at most one job can be identified with "----".
  84.                     If there is any suspended job, then the current job will
  85.                     be a suspended job. If there are at least two suspended
  86.                     jobs, then the previous job will also be a suspended job.
  87.  
  88.      <job-number>   A number that can be used to identify the process group to
  89.                     the wait, ffffgggg, bbbbgggg and kkkkiiiillllllll utilities. Using these
  90.                     utilities, the job can be identified by prefixing the job
  91.                     number with "%%%%".
  92.  
  93.      <state>        One of the following strings (in the POSIX locale):
  94.  
  95.                     RRRRuuuunnnnnnnniiiinnnngggg            Indicates that the job has not been
  96.                                        suspended by a signal and has not
  97.                                        exited.
  98.  
  99.                     DDDDoooonnnneeee               Indicates that the job completed and
  100.                                        returned exit status zero.
  101.  
  102.                     DDDDoooonnnneeee((((ccccooooddddeeee))))         Indicates that the job completed
  103.                                        normally and that it exited with the
  104.                                        specified non-zero exit status, code,
  105.                                        expressed as a decimal number.
  106.  
  107.                     SSSSttttooooppppppppeeeedddd
  108.  
  109.                     SSSSttttooooppppppppeeeedddd ((((SSSSIIIIGGGGTTTTSSSSTTTTPPPP))))  Indicates that the job was suspended by
  110.                                        the SSSSIIIIGGGGTTTTSSSSTTTTPPPP signal.
  111.  
  112.                     SSSSttttooooppppppppeeeedddd ((((SSSSIIIIGGGGSSSSTTTTOOOOPPPP))))  Indicates that the job was suspended by
  113.                                        the SSSSIIIIGGGGSSSSTTTTOOOOPPPP signal.
  114.  
  115.                     SSSSttttooooppppppppeeeedddd ((((SSSSIIIIGGGGTTTTTTTTIIIINNNN))))  Indicates that the job was suspended by
  116.                                        the SSSSIIIIGGGGTTTTTTTTIIIINNNN signal.
  117.  
  118.                     SSSSttttooooppppppppeeeedddd ((((SSSSIIIIGGGGTTTTTTTTOOOOUUUU))))  Indicates that the job was suspended by
  119.                                        the SSSSIIIIGGGGTTTTTTTTOOOOUUUU signal.
  120.  
  121.                                        The implementation may substitute the
  122.                                        string SSSSuuuussssppppeeeennnnddddeeeedddd in place of SSSSttttooooppppppppeeeedddd.
  123.                                        If the job was terminated by a signal,
  124.                                        the format of <state> is unspecified,
  125.                                        but it will be visibly distinct from
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. jjjjoooobbbbssss((((1111))))                                                                jjjjoooobbbbssss((((1111))))
  137.  
  138.  
  139.  
  140.                                        all of the other <state> formats shown
  141.                                        here and will indicate the name or
  142.                                        description of the signal causing the
  143.                                        termination.
  144.  
  145.      <command>          The associated command that was given to the shell.
  146.  
  147.      If the ----llll option is specified, a field containing the process group ID is
  148.      inserted before the <state> field. Also, more processes in a process
  149.      group may be output on separate lines, using only the process ID and
  150.      <ccccoooommmmmmmmaaaannnndddd> fields.
  151.  
  152. EEEEXXXXIIIITTTT SSSSTTTTAAAATTTTUUUUSSSS
  153.      The following exit values are returned:
  154.  
  155.      0   Successful completion.
  156.  
  157.      >0  An error occurred.
  158.  
  159. AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN UUUUSSSSAAAAGGGGEEEE
  160.      The ----pppp option is the only portable way to find out the process group of a
  161.      job because different implementations have different strategies for
  162.      defining the process group of the job. Usage such as $$$$((((jjjjoooobbbbssss ----pppp)))) provides
  163.      a way of referring to the process group of the job in an implementation-
  164.      independent way.
  165.  
  166.      The jjjjoooobbbbssss utility will not work as expected when it is operating in its
  167.      own utility execution environment because that environment will have no
  168.      applicable jobs to manipulate. See the APPLICATION USAGE section for bbbbgggg.
  169.      For this reason, jobs is generally implemented as a shell regular built-
  170.      in.
  171.  
  172. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  173.      bbbbgggg((((1111)))),,,, ffffgggg((((1111)))),,,, kkkkiiiillllllll((((1111)))),,,, sssshhhh((((1111)))),,,, wwwwaaaaiiiitttt((((1111))))....
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.